package vip.xiaonuo.biz.modular.meetingreservation.service;

import vip.xiaonuo.biz.modular.meetingreservation.entity.MeetingReservation;

import java.util.Date;

/**
 * 会议室预约状态管理Service接口实
 *
 * @author 沐雨眠竹
 * @date  2025/05/15 10:05
 **/
public interface MeetingReservationStatusService {

    /**
     * 设置预约结束时间并创建延时队列任务
     *
     * @param meetingReservation 会议室预约信息
     */
    void setReservationEndTime(MeetingReservation meetingReservation);

    /**
     * 将预约ID添加到Redis延时队列
     *
     * @param reservationId 预约ID
     * @param execTime 执行时间（时间戳）
     */
    void addToDelayQueue(String reservationId, long execTime);

    /**
     * 根据预约日期和时间段计算结束时间
     *
     * @param reservationDate 预约日期
     * @param timeSlot 时间段
     * @return 结束时间
     */
    Date calculateEndTime(String reservationDate, String timeSlot);

    /**
     * 更新预约状态为已完成
     *
     * @param reservationId 预约ID
     */
    void updateReservationStatus(String reservationId);

    /**
     * 从延时队列中移除预约
     *
     * @param reservationId 预约ID
     */
    void removeFromDelayQueue(String reservationId);

    /**
     * 处理延时队列中的到期任务（定时任务）
     */
    void processDelayQueue();
}
